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THE TOOL 


GENERALITÀ 


I! software "THE TOOL" per il personal computer COMMODORE 64 è un potente complemento al 
vostro sistema che rende più semplice l'uso del computer e nello stesso tempo ne aumenta notevol¬ 
mente le possibilità. 

Il software consiste in un nuovo set di istruzioni tipo BASIC, di facile e rapida comprensione, che mi¬ 
gliorano la gestione dello schermo, permettono di tracciare linee verticali ed orizzontali, di ottenere 
efficienti routine per l'acquisizione dati, di variare i colori presenti sullo schermo, di disegnare in gra¬ 
fica ad alta risoluzione con la contemporanea presenza di testo ed infine di memorizzare su floppy 
disk e richiamare dallo stesso pagine di schermo con grafica e testo. 

Il software "THE TOOL" comprende inoltre alcune istruzioni di estrema utilità per la programmazione 
nella stesura e nel debug dei programmi, nonché altre caratteristiche interessanti quali una funzio¬ 
ne riservata al joystick e delle istruzioni per gestire stringhe di caratteri. 

Le istruzioni per il supporto DOS sono state inserite per gestire con maggior semplicità l'unità a floppy 
disk. 

Questo manuale è stato redatto allo scopo di costituire sia uno strumento per imparare ad usare THE 
TOOL, che uno strumento di riferimento. Si consiglia di leggere attentamente il manuale stesso per 
ottenere tutti gli elementi che assicurano un'utilizzazione efficace e razionale del software "THE 
TOOL". 

Un'occhiata agli esempi e la loro lettura mentre girano sul vostro COMMODORE 64 vi permetteranno 
di prendere molto rapidamente confidenza con tutte le possibilità del sistema. 








































THE TOOL 


INSTALLAZIONE 


GENERALITÀ 

Il software THE TOOL è memorizzato su una cartuccia. 

È sufficiente inserire la cartuccia nel connettore di espansione della memoria, collocato sul retro del 
COMMODORE 64, ed accendere quest'ultimo. THE TOOL viene automaticamente caricato nella me¬ 
moria del computer, e vi sono ancora 30 k della stessa a vostra disposizione. In questo momento tutta 
la potenza del "THE TOOL" è ai vostri ordini. 


Nota: la forma dello cartuccia dovrebbe evitare ogni confusione per il suo inserimento, in ca¬ 

so di dubbio, fate riferimento alla "Guida per l'utente" del COMMODORE 64 che vi 
permetterà di individuare con sicurezza il connettore in cui inserire la cartuccia. 
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THE TOOL 


GENERATORE DI SCHERMO 


GENERALITÀ 

Il generatore di schermo presente nel software "THE TOOL" ha lo scopo di facilitare l'acquisizione 
dati sullo schermo. L'acquisizione, infatti, diventa più affidabile che con le normali routine in BASIC e 
l'esecuzione, fondamentale nella gestione dello schermo, diventa più veloce essendo il software scrit¬ 
to in linguaggio macchina. 

THE TOOL controlla le seguenti funzioni: 

comandi di visualizzazione per tracciare linee verticali ed orizzontali, per effettuare lo serali dello 
schermo, etc... 

comandi di acquisizione per definire zone di acquisizione e controlli associati, per allocare contenuti 
di particolari zone dello schermo a variabili BASIC, per un più completo utilizzo delle possibilità di 
stampa. 

comandi per la gestione dello schermo a pagina per caricare su floppy e richiamare da floppy pagine 
di schermo. 

Nelle pagine seguenti, i nomi utilizzati per le variabili sono arbitrari e sono scelti in modo da ottenere 
la miglior comprensione. Qualunque variabile BASIC può essere scelta a tale scopo, tranne le varia¬ 
bili riservate per THE TOOL: "zo" ed "ok". 

Lo schermo viene definito come una superficie su cui disegnare con l'origine degli assi nell'angolo in 
alto a sinistra. L'origine ha coordinate 1.1. Ogni punto dello schermo è definito per mezzo delle coor¬ 
dinate: 

I = numero di riga 
c — numero di colonna 
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THE TOOL 


GENERATORE DI SCHERMO 


GENERALITÀ (contìnua) 

In generale si ha: 

I : numero di linea (o di riga) (1 <= 1 <= 25) 
c : numero di colonna (1 <= c <= 40) 

In: lunghezza di riga (o numero delle colonne) - linea orizzontale 
lg: altezza di colonna (o numero delle righe) - linea verticale 

Per una miglior comprensione di quanto detto in questo capitolo, provate questi comandi sullo scher¬ 
mo del vostro sistema, in modo diretto o da programma. 

Una pagina di schermo è qualunque cosa si trova sullo schermo in un determinato istante. È possibile 
creare pagine complete sullo schermo, caricarle su floppy disk, richiamarle direttamente sullo scher¬ 
mo, inserire dei dati ed effettuare anche altre operazioni. 


MODO GRAFICO/MODO TESTO 

Si vedrà che è possibile utilizzare contemporaneamente testo e grafica e memorizzare il tutto su floppy 
disk. Le istruzioni grafiche saranno esaminate nel prossimo capitolo. Per ora le istruzioni che seguono 
non verranno utilizzate con la grafica. 

Esistono due modi di funzionamento: il modo TEXT (per i testi) ed il modo GRAPHIC (per la grafica). 
Nel capitolo 3 saranno esaminate le istruzioni in modo Text, mentre nel capitolo 4, quelle per il modo 
Graphic. Il modo di default è comunque il modo Text. 
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THE TOOL 


GENERATORE DI SCHERMO 
Istruzioni di visualizzazione 


TLINE 


tline 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 


tline permette di disegnare sullo schermo una linea orizzontale definita per mezzo della 
lunghezza e dell'origine. 

tline In, I, c 

dove 

In: lunghezza della linea orizzontale 
I : numero di riga dell'origine della linea orizzontale 
c : numero di colonna dell'origine della linea orizzontale 

il comando tline permette di disegnare tabelle e cornici sullo schermo o di sottolineare 
dati e titoli. 

tline 22, 1, 1 
tline 22, 12, 1 

Queste due istruzioni tracciano due linee orizzontali parallele nella parte superiore 
dello schermo. 
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THE TOOL 


GENERATORE DI SCHERMO 

Istruzioni di visualizzazione 


TCOl 


tcol 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 

Note: 


tcol permette di disegnare sullo schermo una linea verticale definita per mezzo della 
lunghezza e dell'origine. 

tcol. In, I, c 

dove 

In: lunghezza della linea verticale 
I : numero di riga dell'origine della linea verticale 
c : numero di colonna dell'origine della linea verticale 

il comando tcol permette di disegnare tabelle e cornici sullo schermo (assieme al co¬ 
mando tline). 

tcol 12, 1, 1 
tcol 12, 1, 22 

Queste due istruzioni tracciano due linee verticali parallele nella parte superiore dello 
schermo. 

10 Hine 22, 1, 1 : tline 22, 12, 1 
20tcoll2, 1,1 : tcol 12,1,22 

Queste due linee di comandi BASIC tracciano una cornice sullo schermo. Notare che le 
intersezioni agli angoli sono disegnate correttamente. 


3-4 



THE TOOL 

dear 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempi: 


GENERATORE DI SCHERMO CLEAR 

Istruzioni di visualizzazione 


dear cancella una zona definita sullo schermo. 

clear 1, c, Ig, In 

dove 

I : numero di riga del punto di partenza 

c : numero di colonna del punto di partenza 

Ig: altezza della zona da cancellare (numero di righe) 

In: lunghezza della zona da cancellare (numero di colonne). 

il comando clear permette di cancellare una parte dello schermo definita per mezzo dei 
parametri. 

per cancellare la prima riga dello schermo 
clear 1, 1, 1, 40 

per cancellare la cornice definita negli esempi precedenti e tutto ciò che è compreso in 
essa 

30 clear 1, 1, 12,22 

(cancella una "finestra" di 12 righe per 32 colonne). 
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THE TOOL 

out 

Funziona: 

Sintassi: 

Utilizzaziona: 

Esempio: 


GENERATORE DI SCHERMO OUT 

Istruzioni di visualizzazione 


visualizzazione sullo schermo una stringa a$ in una posizione data. 

out a$, 1, c 

dove 

a$: una stringa qualunque 
I : numero di rigo del punto di partenza 
c : numero di colonna del punto di partenza 

il comando out visualizzo una qualunque stringa in un qualunque punto dello schermo 
senza dover usare il cursore. Out rende inoltre più facile il riempimento di maschere. 

40 ai = "JOHN SMITH" 

SO out a$, 5, 10 

Questa sequenza di comandi visualizza la scritta JOHN SMITH sulla quinta riga dal¬ 
l'alto a partire dalla decima colonna. 
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THE TOOL 

rev 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 


GENERATORE DI SCHERMO REV 

Istruzioni di visualizzazione 


rev trasforma in modo inverso una porzione di schermo definita dal suo punto di ori¬ 
gine, dalla lunghezza, dall'altezza e dal colore. 

rev I, c, Ig, In [,co] 

dove 

I : numero di riga del punto di partenza 
c : numero di colonna del punto di partenza 
Ig : altezza della finestra (o numero delle righe) 

In : lunghezze della finestra (o numero delle colonne) 
co: nuovo colore: opzionale (da 0 a 15 - vedi pag. 3-21) 

il comando rev permette di operare su una porzione dello schermo. Usando l'istruzione 
più di uno volta è possibile far lampeggiare la finestra. La frequenza del lampeggio 
può essere regolata per mezzo di loop temporali (for: next). 

utilizzare il modo inverso p-er i nomi dell'esempio precedente. 

140 rev 5, 1, 1, 10, 3 : rev 6, 10, 1, 11,4 
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THE TOOL 


GENERATORE DI SCHERMO 
Istruzioni di visualizzazione 


SCROU 


scroti 

Funzione: 


Sintassi: 


Utilizzazione: 


Esempio: 


Nota: 


serali provoca uno scorrimento verso l'alto o verso il basso, verso destra o verso sini¬ 
stra di una porzione dello schermo o di una finestra definita dal suo punto di origine, 
dalla lunghezza e dall'altezza. 

serali I, c, Ig, In, ty 

dove 

I : numero di riga del punto di partenza 
c : numero di colonna del punto di partenza 
Ig : altezza della finestra o numero delle righe 
In : lunghezza della finestra o numero delle colonne 
ty : tipo dello scrolling con: 

-n: verso l'alto (up) 

—d: verso il basso (down) 

I : verso sinistra (teff) 
r : verso destra (right) 

il comando serali permette di visualizzare file di dati troppo grandi per essere visualiz¬ 
zati una sola riga. Con un semplice codice è possibile quindi far scorrere i dati in una fi¬ 
nestra e, non appena si trova il dato desiderato, memorizzarlo, procedendo quindi con 
l'esecuzione del programma. 

10 sclear 

30 a$ = "JOHN" : b$ = "PATTY" : c$ = "JULIE" 

40 out a$, 11, 4 : out b$, 11, 10 : out c$, 11, 17 
50 for i = 0 to 9 
60 serali 10 - i, 4, 2, 4, u 
70 clear 11 - i, 4, 1,4, 

80 serali 11 + i, 17, 2, 5, d 
90 clear 11 + i, 17, 1,5 
100 for j - 1 to 200 : next j 
110 next i 
120 end 

Fate girare il programma ed osservate che cosa succede. Quindi eliminate le linee 70 
e 90 e notate le differenze, effettuate poi esempi simili con lo scrolling a sinistra ed a 
destra. 

durante lo serali non viene cancellato ciò che era visualizzato in precedenza. 
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THE TOOL 


GENERATORE DI SCHERMO 
Istruzioni di acquisizione doti 


GENERALITÀ 

Le istruzioni di acquisizione di THE TOOL hanno lo scopo di essere utilizzate in sostituzione delle istru¬ 
zioni INPUT e GET, per permettere un'àcquisizione dati omogenea, controllata, efficiente ed affidabile. 

Questa sezione è dedicata ai comandi per l'acquisizione. Una zona dello schermo viene definita per 
mezzo di alcuni parametri (punto di origine, dimensioni, tipo permesso di caratteri, possibilità uscita 
(oltre che return) ed un numero di identificazione), (decz) 

Una volta definita la zona, il comando reqz istruisce THE TOOL a prelevare i dati da essa, effettuare i 
controlli desiderati e riprodurre le funzioni di controllo della pagina come: spostare il cursore, can¬ 
cellare, inserire. Il comando inz effettua il trasferimento dell'informazione da una zona ad una stringa 
(il comando outz effettua l'operazione inversa). 

Su una pagina di schermo possono essere definite fino a 128 differenti zone, 
input a$ decz 1 : definizione della zona 

reqz 1 : acquisizione controllata 

inz 1, a$: trasferimento in a$ 

Ulteriori informazioni saranno date nelle pagine seguenti. 
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THE TOOL 

decz 

Funzione: 

Sintassi: 


Esempio: 

Utilizzazione: 


GENERATORE DI SCHERMO DECZ 

Istruzioni di acquisizione dati 


decz permette di definire tutti i parametri relativi ad una zona dello schermo per control¬ 
lare l'acquizione dati. 

decz n, I, c, In [, ty] [, f, $] 

dove 

n : numero di identificazione (o < = n < = 127) 

I : numero di riga del punto di partenza (1 < = I < = 23) 

c : numero di colonna del punto di partenza (1 < = c < = 22) 

In: lunghezza totale della zona (1 < = In < = 255) 
ty: tipo della zona di controllo con: 

— n : solo dati numerici 

— m: dati in lettere maiuscole 

— r : altre possibilità di uscita oltre a RETURN 

* per una zona numerica: quasi tutti i tasti tranne quelli numerici 

* per una zona alfanumerica: tutti i tasti non alfanumerici. 

II codice ASCII dei tasti premuti per uscire viene posto nella variabile zo, per cui è possibile 
definire ed usare i tasti di controllo nel seguente modo: 

da FI ad F8: zo = da 133 a 140 

CRSR/DOWN: zo = 17 
CRSR/UP: zo = 145 

SHIFT/RETURN: zo = 141 
CTRL/da A a Z: zo = do 1 a 26 

— p: zona definita in stampa + f$ 

f$: stringa contenente il formato di stampa. 

Un formato può definire una zona. Quando si prendono o si visualizzano dati in questa 
zona, il suo contenuto è formattato. Il formato è memorizzato in una stringa (in questo 
coso f$). I caratteri di controllo sono: 

— 9: numerico 

— 8: numerico; poni a zero se zero 

— 1 : posizione del segno (solo -) 

— 2: posizione del segno (con + o -) 

Qualunque carattere alfanumerico può essere inserito in un format. 
f$ = "$ 19,999,998.88" 

decz permette di definire la zona di acquisizione con la massima precisione possibile. 
È possibile operare con efficienza e facilità in una zona utilizzando semplicemente il suo 
numero di identificazione. 
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THE TOOL 


GENERATORE DI SCHERMO 

Istruzioni di acquisizione dati 


DECZ 

(continua) 


decz 

Esempio: 


Note: 


decz 2,l,2,10,n,p,"199 999.88" 

Questo esempio definisce una zona (numero 2) con un punto di origine (1,2) lunga 10 
caratteri. Sono accettati solo valori numerici (n). Il formato di stampa provoca la stam¬ 
pa del solo segno - se è meno ed uno zero viene forzato al termine del numero. Il nume¬ 
ro sarà di 5 cifre con due cifre dopo il punto decimale. 

Nella stessa istruzione decz può essere combinato più di un tipo. Sono accettate tutte le 
seguenti combinazioni: 


n 

solo numeri 

- RETURN per lasciare la zona 

n,r : 

solo numeri 

- un tasto programmabile 

n,p 

solo numeri formattati 

per lasciare la zona 
- RETURN per lasciare la zona 

n,r,p : 

solo numeri formattati 

- un tasto programmabile 

m 

solo lettere maiuscole 

per lasciare la zona 
- RETURN per lasciare la zona 

m,r 

solo lettere maiuscole 

- un tasto programmabile 

r 

qualunque carattere è accettato 

per lasciare la zona 
- un tasto programmabile 

P 

r,p 

(nulla): 

(equivalente ad n,p) 
(equivalente ad n,r,p) 
qualunque carattere è accettato 

per lasciare la zona 

- RETURN per lasciare la zona 


Se i dati vanno in overflow sulla zona di acquisizione, la zona viene illuminata e quindi 
cancellata totalmente. Il cursore si riporta all'inizio della zona. Ciò impedisce di lascia¬ 
re la zona se il formato non è corretto (il formato viene controllato premendo RETURN). 

Se provate ad usare l'istruzione decz senza usare una istruzione reqz subito dopo, non 
accade nulla, ma la dichiarazione rimane. 
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THE TOOL 


GENERATORE DI SCHERMO 
Istruzioni di acquisizione dati 


REQZ 


reqz 

Funzione: 

Sintassi: 

Utilizzazione: 


Esempio: 


reqz effettua l'acquisizione secondo i parametri specificati nella precedente istruzione 
decz. 

reqz n 

dove 

n: numero di identificazione della zona 

il comando reqz viene usato in coppia con il comando decz già descritto. Se non esiste 
una corrispondente istruzione decz (oppure se la stessa non è stata caricata in una pa¬ 
gina di schermo), viene generato un messaggio di errore. 

Con questo comando, THE TOOL effettua l'acquisizione dati sotto il suo controllo, co¬ 
me definito nella dichiarazione di zona. Durante l'esecuzione del comando, il cursore 
viene portato all'inizio della zona interessata. 

Nella zona possono essere usati i comandi CLR, HOME, CURSOR BACK e FORWARD, 
INST/DEL. 

L'acquisizione dati è controllata come definita nella dichiarazione di zona. 

Se il modo di definizione della zona è r ed il codice di uscita è differente da 13 (zo), il 
cursore ritorna nella posizione che occupava durante l'uscita dalla zona quando si ef¬ 
fettua un nuovo ingresso nella stessa. 

se avete già introdotto l'esempio precedente (decz 2, ....) introducete ora: 
reqz 2 

e notate quello che succede. Saranno accettati solo valori numerici. 
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THE TOOL 


inz 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 


Note: 


GENERATORE DI SCHERMO INZ 

Istruzioni di acquisizione dati 


inz trasferisce il contenuto di una zona in una variabile di stringa. 

inz n, a$ 

dove 

n : numero di identificazione della zona 
a$: uria qualunque variabile di stringa 

il comando inz è utilizzato per trasferire il contenuto di una zona in una stringa, quando 
tutti i dati in quella zona sono corretti. 

inz 2, a$ 

Dopo aver effettuato i due esempi precedenti, questo comando trasferisce il contenuto 
della zona in a$. Per verificare se è vero, battere: 

out a$,3,5 

lOdecz 1,25,10,5,r 
20 reqz 1 : inz 1, a$ 

30 print zo, a$ 

40 goto 20 

la variabile di stringa che riceve il contenuto di una zona deve avere la stessa lun¬ 
ghezza di quella zona, indipendentemente dal contenuto. 
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THE TOOL 


GENERATORE DI SCHERMO 
Istruzioni di acquisizione dati 


OUTZ 


outz 


Funzione: 

outz visualizza una stringa in una zona 

Sintassi: 

outz n, a$ 


dove 


n : numero di identificazione della zona 
a$: qualunque variabile di stringa 

Utilizzazione: il comando outz è l'istruzione opposta di inz. I dati vengono trasferiti da una variabile 
ad una zona. Questa istruzione è simile all'istruzione out, ma è più facile da usare e 
più precisa. 

Più facile da usare perché è sufficiente il numero di identificazione della zona anziché 
le coordinate del punto iniziale. 

Più precisa perché assume tutti i controlli definiti nella zona con il comando decz. 

Esempio: usando ancoro gli esempi precedenti, battere a$ = "11111" 

outz = 2,a$ 

Note: se nella zona definita per la stampa si verifica un'overflow dei decimali, il numero viene 

troncato. Se si verifica invece un'overflow di capacità, la zona viene riempita con 


nel caso di un comando outz in una zona dichiarata senza impegno (stampa senza 
1 o 2), di una stringa con un +, un —, un blank come primo carattere, la stringa può es¬ 
sere troncata di una cifra, oppure sullo schermo può essere sostituita con degli asteri¬ 
schi. Per evitare ciò, occorre estrarre il segno con la sequenza: 

a = len (mo$) — 1 : mo$ = right$ (mo$,a) 
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THE TOOL 


GENERATORE DI SCHERMO 
Istruzioni di acquisizione dati 


CLEARZ 


clearz 


Funzione: 

clearz cancella una zona. 

Sintassi: 

clearz ni [to n2] 


dove 

ni, n2: numeri di identificazione di una zona. 


Utilizzazione: il comando clearz può essere usato per cancellare i contenuti di una maschera senza 
cancellare la maschera stessa, dopo un'acquisizione e prima di una nuova acquisizione. 

Esempio: clearz 2 
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THE TOOL 


GENERATORE DI SCHERMO 
Istruzioni di ocquisizione dati 


CARGET 


carget 

Funzione: 

Sintassi: 


Utilizzazione: 


Esempio: 


Note: 


carget arresta l'esecuzione di un programma ed attende l'introduzione di un carattere 
predefinito. 

carget a$ [, 1, c] 

dove 

a$: stringa contenente i caratteri accettati 

l,c: (opzionali) posizione dove deve apparire il cursore sullo schermo 
il comando carget sostituisce la ben nota sequenza in BASIC: 

100 get a$ : if a$ = " " then 100 
con ulteriori possibilità 
100 carget "abc" 

arresta l'esecuzione del programma fino a che non vengono introdotti a, b oppure c. 

Dopo un comando carget, le variabili ok e zo assumono i seguenti valori: 

ok: puntatore di posizione del carattere scelto nella stringa (a ok= 1, b ok=2, c ok=3) 

zo: codice ASCII del carattere scelto (a zo=65, b zo=66, c zo=67) 

BASIC 

100 get a$ : if a$= " " then 100 
110 if a$= "A" then gosub 1000: goto 200 
120 if a$= "B" then gosub 2000: goto 200 
130 if a$= "C" then gosub 3000: goto 200 
140 if a$= "Z" thè gosub 4000: goto 200 
150 goto 100 

200 rem *** fine del programma *" 

THE TOOL 

100 a$= "ABCZ" : carget a$, 24, 20 

110 on ok then gosub 1000, 2000, 3000, 4000 

200 rem *** fine del programma **' 

È evidente il risparmio di linee di programma. 

Se a$ è una stringa vuota (a$= " tutti i caratteri sono accettati. 

100 carget " " 

Questa istruzione arresta l'esecuzione del programma finché non viene premuto un ta¬ 
sto qualunque. 

Usando il comando carget con i parametri 1, c'è possibile definire la frequenza di lam¬ 
peggiamento del cursore con l'istruzione poke 703,n dove n : valore della frequenza 
del lampeggio (normale n=100). 
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THE TOOL 


GESTIONE DELLO SCHERMO 
istruzioni per la gstione di pagine dello schermo 


GENERALITÀ 

In applicazioni commerciali, le maschere di acquisizione dati sono spesso simili e vengono utilizzate 
più di una volta con differenti informazioni. In un normale programma BASIC, una nuova maschera 
deve essere ricreata ogni volta con notevole dispendio sia di tempo che di memoria. 

THE TOOL definisce una pagina dello schermo con tutte le istruzioni di dichiarazioni (decz) e la me¬ 
morizza su floppy disk evitando la necessità di creare nuovamente la maschera. Applicazioni diffe¬ 
renti possono quindi avere le proprie pagine di schermo con le proprie maschere. La codifica del pro¬ 
gramma è notevolmente semplificata. 

La pagina può essere successivamente richiamata sullo schermo ed in essa si possono inserire i dati. 
È sempre possibile scambiare la maschera presente sullo schermo con una memorizzata su floppy, ad 
esempio un maschera di HELP. 

Se, durante un'acquisizione, si dimentica ad esempio la sintassi di un comando di controllo, il pro¬ 
gramma può facilmente effettuare uno scambio di pagine richiamando sullo schermo una pagina di 
HELP e salvando la pagina di lavoro sul floppy. Dopo aver effettuato le verifiche necessarie, si effettua 
l'operazione inversa e l'esecuzione del programma riprende dal punto in cui era rimasto. Il cursore 
riappare nel punto esatto dove si trovava prima di effettuare lo scambio. 

Le tre istruzioni descritte in questa sezione effettuano le seguenti azioni: 

- ssave : memorizza su floppy la pagina presente sullo schermo 

- sload richiama sullo schermo una pagina memorizzata su floppy 

- sclear: cancella lo schermo 

Note: come si vedrà con più dettagli nel capitolo seguente, le istruzioni ssave ed sload pos¬ 

sono essere usate sia in modo Text che in modo Graphic. 

Una pagina di testo sullo schermo può occupare 8-9 blocchi in funzione del numero 
delle zone. 

Una pagina grafica occupa invece 33 blocchi. 

È possibile caricare una pagina che non corrisponde al modo corrente (es. caricare 
una pagina grafica in modo Text). La pagina specificata verrà comunque caricata nella 
corretta parte di memoria. 
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THE TOOL 


GESTIONE DELLO SCHERMO 
Istruzioni per la gestione di pagine dello schermo 


SSAVE 


ssave 

Funzione: 

Sintassi: 


Utilizzazione: 

Esempio: 

Note: 


ssave memorizza la pagina dello schermo su floppy disk 

ssave du, "nome" [, ni] [, n2 to n3] [, ...] 

dove 

du : numero logico dell'unità a floppy disk (normalmente 8) 

nome : nome assegnato alla pagina 
ni, n2, n3: zone associate (opzionali) 

il comando ssave salva la pagina presente sullo schermo. Anche le zone (decz) pos¬ 
sono essere salvate per mezzo dei parametri ni, n2 ed n3 che sono opzionali. 

In ogni caso, viene salvata l'intera pagina (maschera, dati, etc.) 

ssave 8, "prgl", 1, 12, 30 to 70 

1) ssave 8, "nome", 0 to 127 salva tutte le dichiarazioni associate. Non ci sono errori 
se sono salvate le zone non dichiarate. 

2) può anche essere usata la forma ssave 8, " @ 0 : prgl" 

3) ssave memorizza l'intero schermo (testo o grafica). Nel caso di modo grafico, le zo¬ 
ne associate danno un errore di sintassi. 
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THE TOOL 


GESTIONE DELLO SCHERMO 
Istruzioni per la gestione di pagine dello schermo 


SLOAD 


sioad 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 

Note: 


sioad richiama sullo schermo una pagina precedentemente memorizzata su floppy disk. 

sioad du, "nome" 

dove 

du : numero logico dell'unità a floppy disk (generalmente 8) 
nome: nome assegnato alla pagina 

il comando sioad è l'istruzione inversa di ssave. La pagina richiamata viene diretta- 
mente visualizzata sullo schermo. Tutte le zone vengono nuovamente dichiarate. 

sioad 8, "progl" 

nessuna 
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THE TOOL 


sdear 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 

Note: 


GESTIONE DELLO SCHERMO SCLEAR 

Istruzioni per la gestione di pagine dello schermo 


sdear cancella completamente una pagina dello schermo 
sclear 

senza parametri 

il comando sclear cancella totalmente lo schermo, compresi i dati acquisiti con le istru¬ 
zioni decz, regz, ed inz. Tuttavia il comando non distrugge le dichiarazioni dei dati. 

sclear 

nessuna 
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THE TOOL 


GENERATORE DI SCHERMO 
Definizione dei colori dello schermo 


SCREEN 


screen 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempi: 

Note: 


screen permette di modificare i colori dello schermo, dei bordi e dei caratteri visualiz¬ 
zati con THE TOOL. 

screen se, br [, cr] 

dove 

se: colore dello schermo (0 <= se <= 15) 
br: colore dei bordi (0 <= br <= 15) 

cr: colore dei caratteri (0 <= cr <= 15) (parametro opzionale) 

con il comando screen è possibile definire facilmente i colori dello schermo, dei bordi 
e dei caratteri visualizzati con THE TOOL (per mezzo dei comandi tline, tcol, out, outz, 
regz - fare riferimento alle singole istruzioni). 

Se il colore dei caratteri è ad esempio BLU, la modifica di questo colore con il comando 
screen avrà effetto solo su quei caratteri visualizzati per mezzo delle istruzioni di THE TOOL. 

10 rem *** DISEGNAMO ALCUNE BANDIERE *** 

20 sclear : screen 1,6,2 : out "U.S.A", 12,20 : carget" " 

30 sclear : screen 1,5,2 : out "ITALIA", 12,20 : carget" " 

40 sclear : screen 0,2,7 : out "GERMANIA", 11,7 : carget" " 

50 sclear : screen 1,2,2 : out "GIAPPONE", 11,9 : carget" " 

1) Tavola dei codici colore 


Parametri Colore Codice 

Nero 0 

Bianco 1 

Rosso 2 

Ciano 3 

validi Porpora 4 

per Verde 5 

se, br Blu 6 

e Giallo 7 

cr Arancione 8 

Arancione chiaro 9 

Rosa 10 

Ciano chiaro 11 

Porpora chiaro 12 

Verde chiaro 13 

Blu chiaro 14 

Giallo chiaro 15 


2) I comandi STOP e RESTORE riportano i colori originali (schermo nero e caratteri 
bianchi). 
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THE TOOL 


ISTRUZIONI GRAFICHE 


GENERALITÀ 

Nel precedente capitolo è stata introdotta la distinzione tra modo Text e modo Graphic. in esso è stato 
descritto il generatore di schermo con le istruzioni di visualizzazione, acquisizione dati e gestione delle 
pagine di schermo che funzionano sullo schermo normale 40 x 25 corrispondente al modo Text nel soft¬ 
ware THE TOOL. 

Vediamo ora le istruzioni che permettono di disegnare su schermo grafico ad alta risoluzione (320 x 
200). Lo schermo grafico viene definito come una superficie su cui disegnare con l'origine degli assi 
nell'angolo in basso a sinistra, ogni punto dello schermo grafico ad alta risoluzione è definito per mez¬ 
zo di una coppia di coordinate (ascissa ed ordinata). 
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THE TOOL 


ISTRUZIONI GRAFICHE 


GRAPHIC 


graphic 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 


Note: 


graphic pone il COMMODORE 64 in modo Graphic ad alta risoluzione, 
graphic 

senza parametri 

il comando graphic deve essere usato quando sta per essere eseguita una sequenza di 
istruzioni grafiche. Il comando riserva la memoria necessaria per la gestione della gra¬ 
fica ad elevata risoluzione. 

10 tline 40,1,1 : tline 40,25,1 
20 tcol 25,1,1 :tcol 25,1,40 
30 ssave 8, "frame" 

40 graphic 

50 rem *** serie di istruzioni grafiche (fare riferimento alle pagine successive) *** 

60 ssave 8, "graphic" 

70 rem *** siamo ancora in modo graphic *** 

Quando si desidera ritornare in modo Text è sufficiente usare l'istruzione text (pagina 
4 - 7). 
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THE TOOL 


ISTRUZIONI GRAFICHE 


MOVE 


move 

Funzione: move permette di spostare il cursore grafico in qualunque parte dello schermo. 

Sintassi: move x, y 

dove 

x: coordinata orizzontale (0 <= x <= 319) 
y: coordinata verticale (0 <= y <= 199) 

Utilizzazione: il comando move permette di disegnare un punto od una linea in qualunque posizione 
dello schermo. Il comando move sposta solamente il cursore, senza disegnare nullo 
sullo schermo. 

Esempio: 10 graphic 

20 move 0,0 : rem *** sposta il cursore nell'origine (angolo in bosso a sinistra) *** 

30 i = 160 : j = 100 : move i, j 
40 text 

50 rem *** esempi più completi nelle pagine che seguono *** 

60... 

Note: il punto origine in modo Graphic è differente per motivi pratici da quello del generato¬ 

re di schermo. Infatti, la visualizzazione e l'acquisizione sono normalmente effettuate 
dall'alto verso il basso per cui l'origine in modo Text è nell'angolo superiore a sinistra. 
Invece, quando si disegna, il punto origine si trova in basso a sinistro. 
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THE TOOL 


ISTRUZIONI GRAFICHE 


DRAW 


draw 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 


Note: 


draw disegna (o cancella) una linea dal punto dove si trova il cursore (dopo averlo spo¬ 
stato ad esempio con un comando move) al punto di coordinate x, y. 

draw x, y, ty 

dove 

x : coordinata orizzontale (0 <= x <= 319) 
y : coordinata verticale (0 <= y <= 199) 
ty: una variabile numerica 
1: traccia una linea 
0: cancella una lineo 

il comando draw viene utilizzato ogni qualvolta occorra tracciare o cancellare una linea 
retta sullo schermo, in unione al comando move è possibile ottenere qualunque tipo di 
disegno con linee rette. 

05 rem **' disegna un cubo in 3D *** 

10 graphic : sclear 

20 a=0 : b=20 : C—40 : d = 100 

25 move a, a : rem *** cursore nell'origine (angolo in basso a sinistra) *** 

30 draw a,d,1 : draw d,d,l : draw d,a,l : draw a,a,l 
40 draw c,b,l : draw c+d,b,l : draw c+d, b+d,l 
50 draw c,b+d,l : draw a,d,l 
60 move d,a : draw d+c,b,l 
65 move c,b : draw c,b+d,l 
70 move d,d : draw d+c, d+b,l 

80 carget " " : rem *** premere qualunque tasto per ripartire *** 

90 next 

1) Aggiungendo al precedente esempio le linee 130,140,150,160,165 e 170 come do 
30 a 70, ma con 0 anziché 1, si cancella il cubo, linea dopo linea. L'istruzione sclear ha 
lo stesso effetto in modo più rapido (vedere pag. 3 - 20). 

2) Il comando carget (pag. 3-16) senza memoria di riga e di colonna può essere usato 
anche in modo grafico. 

3) Si sarebbe anche potuto usare: 
draw a,d,dr 

dove 

dr = 1 l'istruzione disegna 
dr = 0 l'istruzione cancella 
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THE TOOL 


ISTRUZIONI GRAFICHE 


PIOT 


plot 

Funzione: 

Sintassi: 


Utilizzazione: 

Esempio: 


Note: 


plot disegna o cancella un punto di coordinate x,y 

plot x,y,ty 

dove 

x : coordinata orizzontale (0 <= x <= 319) 
y : coordinata verticale (0 <= y <= 199) 

ty: una variabile numerica 
1 : disegna un punto 
0: cancella un punto 

il comando draw è usato per disegnare o cancellare una cosa diversa da una linea retta. 

05 rem *** disegna un cerchio in un quadrato *** 

10 graphic 

20 a=0 : d=100 : e=50 : pi=3.14159 : pr=.01 dr=l 

25 move a,a : rem ”** cursore nell'origine (angolo in basso a sinistra) *** 

30 draw a,d,dr : draw d,d,dr : draw d,a,dr : draw a,a,dr 
40 for i=0 to 2*pi step pr 
50 plot e*(l +cos(i)), e*(l +sin(i)), dr 
60 next i 

80 carget " " : rem *** premere qualunque tasto per ripartire *** 

90 text 

facendo girare lo stesso programma con dr=0 (linea 20) viene cancellato il circolo e la 
cornice. Il disegno rimane in memoria finché non viene usato il comando scleor o draw 
di tipo 0. 


4 - 4 



THE TOOL 


ISTRUZIONI GRAFICHE 


POINT 


point 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 


Note: 


point verifica se un punto è o non è disegnato sullo schermo alle coordinate x, y. 

point x, y, ty 

dove 

x : coordinata orizzontale (0 <= x <= 319) 
y : coordinata verticale (0 <= y <= 199) 

ty: una variabile numerica 

1 : verifica la presenza di un punto 
0: verifica l'assenza di un punto 

il comando point viene usato per verificare se un punto è o no presente sullo schermo 
a determinate coordinate. Ciò è molto utile per gestire le intersezioni. 

05 rem ********** 

10 graphic 

20 a=0 : d=100 : e=50 : pi=3.14159 : pr=.01 : dim a (100) 

25 move a,a : rem *** cursore nell'origine (angolo a sinistra in basso) *** 

30 draw a,d,l : draw d,d,l : draw d,a,l : draw a,a,l 
40 for i=0 to 100 
50 point 25, i, a(i) 

60 next i 

80 carget" " : rem *** premere qualunque tasto per ripartire *** 

90 text 

100 for i=0 to 100 : print a(i) : next i 

110 rem a(0)+l : a( 100) = 1 : linee verticali della maschera 

nessuna. 
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THE TOOL 


ISTRUZIONI GRAFICHE 


DISPLAY 


display 

Funzione: display visualizza una qualunque stringa di caratteri su schermo grafico usando le con¬ 

venzioni del generatore di schermo su una matrice di 40 colonne e 25 righe (l,c). 

Sintassi: display a$,l,c 

dove 

a$: una qualunque stringa di caratteri 
I : numero della riga del punto di inizio (1 <= I <= 25) 
c : numero della colonna del punto di inizio (1 <= c <=40) 

Utilizzazione: il comando display è molto potente permettendo di unire grafica ad alta risoluzione e 
caratteri sullo stesso schermo. 

Viene usato esattamente come l'istruzione out (vedere pag. 3 - 6). 

Esempio: 05 rem *** alcuni degli esempi precedenti + le linee 70 e 75 *** 

10 graphic 

20 a=0 : d=100 : e=50 : pi=3.14159 : pr=.01 

25 move a,a : rem *** cursore nell'origine (angolo in basso a sinistra) *** 

30 draw a,d,l : draw d,d,l : draw d,a,l : draw a,a,l 
40 for i=0 to 2*pi step pr 
50 plot e*(l+cos(i)), e*(l+sin(i)),l 
60 next i 

70 display "Questo è un cerchio", 5,10 
75 display ",_", 6,10 

80 carget" " : rem *** premere qualunque tasto per ripartire '** 

90 text 

Note: 
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THE TOOL 


ISTRUZIONI GRAFICHE 


TEXT 


text 

Funzione: 

Sintassi: 

Esempio: 


Note: 


text pone fine al modo Graphic ad alta risoluzione e riporta lo schermo in modo Text 
per la visualizzazione e l'acquisizione dati. 

text senza parametri 

05 rem '** alcuni degli esempi precedenti + le linee 70 e 75 "* 

10 graphic 

20 a—0 : d=100 : e=50 : pi = 3.14159 : pr=.01 

25 move a,a : rem *** cursore nell'origine (angolo in basso a sinistra) *** 

30 drow a,d,l : draw d,d,1 : draw d,a,l : draw a,a,1 
40 for i=0 to 2*pi step pr 
50 plot e*(1 +cos(i)), e*(l +sin(i)),1 
60 next i 

70 dispaly "Questo è un cerchio", 5,10 
75 display "_", 6,10 

80 carget" " : rem *** premere qualunque tasto per ripartire *** 

85 ssave 8, " @ 0 : circle. grf" 

90 text 

95 sdear 

96 tline 40,1,1 : tline 40,25,1 : tcol 25,1,1 : tcol 25,1,40 
98 ssave 8, " @ 0 : frame.txt" 

100 end 

lisi 

1) il modo Text è il modo di default all'accensione del sistema 

2) se un'istruzione in modo Graphic viene lanciata in modo Text, viene eseguita come 
se fosse su schermo grafico, ma il suo effetto viene visualizzato solo quando il computer 
sarà commutato in modo grafico. 

3) se un'istruzione in modo Text viene lanciata in modo Graphics essa viene eseguita 
in attesa delle istruzioni ssave ed sclear. 
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THE TOOL 


ISTRUZIONI GRAFICHE 


COLOR 


color 

Funzione: 

Sintassi: 


Utilizzazione: 

Esempio: 


Note: 


color viene usato per caricare nella memoria grafica una matrice colorata 8 punti x 8 
punti. 

color [-] l,c,lg,ln,co 
dove 

[-]{ carattere opzionale 

I : numero di riga del punto di partenza (1 <= I <= 25) 
c : numero di colonna del punto di partenza (1 <= c <= 40) 

Ig : altezza (o numero delle righe) 

In : lunghezza (o numero delle colonne) 

co : nuovo colore (da 0 a 15 - vedere a pag. 3-21) 

il comando color permette di definire un blocco di colore sullo schermo grafico. Viene 
usato esattamente come il comando rev (pag. 3 - 7). 

05 rem *** alcuni degli esempi precedenti + le linee 70 e 75 *** 

10 graphic 

20 a=0 : d=100 : e=50 : pi=3.14159 : pr=.01 

25 move a,a : rem *** cursore nell'origine (angolo in basso a sinistra) *** 

30 draw a,d,l : draw d,d,l : draw d,a,ì : draw a,a,l 
40 for i=0 to 2’pi step pr 
50 plot e*(1 +cos(i)), e*(l +sin(i)),l 
60 next i 

70 color -1,1,25,40,7 
75 color 1,1,25,40,6 

80 carget" " : rem *** premere un tasto qualunque per ripartire *** 

90 text 

lo schermo grafico è costituito da un insieme di punti che sono accesi o spenti. La linea 
70 spegne i punti gialli, mentre la linea 75 accende i punti blu. 
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THE TOOL 


AUSILI! ALLA PROGRAMMAZIONE 
Istruzioni di listing 


AUTO 


auto 

Funzione: 

Sintassi: 

Utilizzazione: 


Esempio: 

Note: 


auto numera automaticamente le linee di programma. 

auto n 

dove 

n: incremento (1 <= n <= 255) 

per ottenere l'autonumerazione delle linee di programma è sufficiente battere auto e 
premere RETURN. Quindi si inizia a scrivere la prima linea di progromma e premendo 
RETURN, appare il numero della linea successiva. 

E però possibile cambiare la numerazione automatica introducendo un numero qual¬ 
siasi. 

Per arrestare la numerazione automatica basta inserire il comando auto senza para¬ 
metri. Lo stesso effetto si ottiene battendo RETURN subito dopo il numero di linea. 

auto 10 

lOfor i=l to 10 

20 

il comando auto può essere usato solamente in modo diretto e non da programma. 


5 - 1 



THE TOOL 


AUSILII ALLA PROGRAMMAZIONE 
Istruzioni di listing 


DELETTE 


delete 

Funzione: 

Sintassi: 


Utilizzazione: 


Esempio: 

Note: 


delete permette di cancellare linee di programma 

delete a 
delete a— 
delete -a 
delete a-b 

dove a,b: numeri di linea del programma 


il comando delete permette di sopprimere linee di programma e funziona analogamen¬ 
te al comando list. 


1 ) delete a 

2) delete a- : 

3) delete -a : 

4) delete a-b: 


cancella la linea a 

cancella le linee a partire da a fino alla fine del programma 
cancella le linee a partire dall'inizio del programma fino alla linea a 
cancella tutte le linee di programma comprese tra le linee a e b. 


delete 20 


1 ) il comando delete senza parametri non viene accettato 

2) il comando delete può essere usato sia in modo diretto, che da programma. 
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THE TOOL 


AUSILII ALLA PROGRAMMAZIONE 
Istruzioni di listing 


RENU 


renu 

Funzione: 

Sintassi: 

Utilizzazione: 


Esempio: 

Note: 


renu effettua la rienumerazione delle linee del programma, 
renu [a[,b[,c]]] 

dove a,b,c sono parametri opzionali il cui significato è spiegato nel seguito. 

il comando renu effettua la rinumerazione delle linee di programma (compresi i co¬ 
mandi goto, gosub, etc). 

Vi sono 4 possibilità: 

1) renu 

rinumera l'intero programma 
la prima linea è 100 
il passo è 10 

2) renu a 

rinumera l'intero programma 
la prima linea è 100 
il passo è a 

3) renu a,b 

rinumera l'intero programma 
la prima linea è a 
il passo è b 

4) renu a,b,c 

rinumera una parte del programma 
a partire dalla linea a 
la prima diventa b 
il passo è c 

renu 20,10 

l'intero programma viene rinumerato con passo 10; la prima linea è numerata 20 
renu può essere usato solo in modo diretto (non da programma). 
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THE TOOL 


dump 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 


Note: 


AUSILII ALLA PROGRAMMAZIONE 
Istruzioni di listing 


DUMP 


dump fornisce l'elenco delle variabili utilizzate in un programma ed i valori loro as¬ 
segnati. 

dump senza parametri 

dump può essere usato in qualunque momento 

- dopo aver lanciato un programma 

- dopo aver fermato con stop un programma (che viene ripreso con cont) 

- dopo un errore di sintassi 

dump non fornisce il contenuto di matrici per evitare sovraccarico dello schermo. 


a=2 : b=3 : a$="test" 

dump 

si ottiene 


a = 2 
b=3 

a$="test" 

dump può essere usato sia in modo diretto che da programma. 
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THE TOOL 


AUSILII ALLA PROGRAMMAZIONE 
Istruzioni di listing 


ERROR 


errar 

Funzione: 

Sintassi: 

Utilizzazione: 


Esempio: 

Note: 


errar dà la posizione di un errore su una linea in BASIC, 
errar senza parametri. 

quando si verifica un errore in un programma BASIC, si arresta l'esecuzione e viene 
dato un messaggio di errore. Per localizzare l'errore basto battere: 

errar 

In tal modo viene visualizzata la linea con l'errore stesso viene rappresentato in campo 
inverso sul video. 

10 a$=STR $(a 

20 end 

run 

errar 

1) error può essere usato solo in modo diretto (non da programma). 

2) dopo che si è verificato l'errore non bisogna usare nessun altro comando prima di 
error (nemmeno list) 


5 - 5 



THE TOOL 


AUSILII ALLA PROGRAMMAZIONE 
Istruzioni di listing 


FINO 


find 

Funzione: 

Sintassi: 


Utilizzazione: 

Esempio: 


Note: 


find permette di cercare una qualunque stringa di caratteri all'interno di un programma. 

find <de> eh <de> [A—B] 

dove 

<de>: un qualunque carattere usato come delimitatore tranne " ed il carattere che si cerca 
eh : i caratteri che si cercano 
A—B : (opzionali) 

A: numero della riga da cui inizia la ricerca 
B : numero della riga a cui termina la ricerca 

il comando find permette di trovare un qualunque carattere od una qualunque stringa 
di caratteri. Ciò può essere estremamente utile durante la correzione di errori di sin¬ 
tassi. Basta cercare il nome con l'errore. 

10 ? "WHITE" 

20 ? "RED" 

30 ?"BLUE" 

40 ? "GLU" 

50 END 

FIND/"GLU"/ : rem or FIND @ giu @ 

find può essere usato sia in modo diretto, che da programma. 
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AUSILII ALLA PROGRAMMAZIONE 
Modo di esecuzione passo-passo 


TRACE 

OFF 


trace 

off 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 

Note: 


trace permette di eseguire un programma un passo alla volta, 
off ritorna al modo normale 

trace senza parametri 
off senza parametri 

quando si usa il modo trace il programma gira una istruzione per volta. La linea in ese¬ 
cuzione viene visualizzata sullo schermo. 

— per visualizzare la linea premere il tasto shift ad ogni istruzione 

— per passare all'istruzione successiva lasciare lo stesso tasto 

— per fermare il modo trace premere contemporaneamente il tasto shift ed il tasto run, 
facendo attenzione di lasciare per primo shift onde evitare il caricamento di un pro¬ 
gramma. 

pensate che sussista un errore alla routine 1000. 

Effettuate il trace: 

100 rem il vostro programma 
110 trace 
120 gosub 1000 
130 off 

140 rem il resto del vostro programma 

trace può essere usato sia in modo diretto che da programma. 
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COMPLEMENTI DI BASIC 


GENERALITÀ 


In questo capitolo sono state raggruppate tutte quelle funzioni che non hanno effetto diretto sullo 
schermo. Dette funzioni semplificano i controlli, migliorano alcune prestazioni del BASIC e facilitano 
la programmazione, in particolare lavorando su stringhe di caratteri. 

Le funzioni descritte nel capitolo sono: 


- hunt 

- creatst 

- ifthenelse: 

- hcopy 

- i°y (n) 


localizza caratteri all'interno di una stringa 
crea una stringa di caratteri 
funzione else 

effettua la copia dello schermo su stampante 
variabile BASIC per il joystick 


Queste funzioni sono indipendenti l'una dall'altra. 
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COMPLEMENTI DI BASIC 

ricerca di caratteri 


HUNT 


hunt 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 

Note: 


hunt trova la posizione di un carattere (o di una serie di caratteri) in una stampa 

hunt [-] ca$, a$, pn 

dove 

— : simbolo opzionale 

senza: ricerca il primo carattere uguale a 

con : ricerca il primo carattere diverso da 

ca$ : stringa da trovare 

a$ : stringa su cui effettuare la ricerca 

pn : puntatore che indica dove inizia la ricerca nella stringa a$ 

il comando hunt permette di controllare operazioni (acquisizione, validazione, ...) e di 
effettuare statistiche. Il risultato viene posto in zo. 

a$ = "pratica owen" 
hunt "a",a$,l 
? zo 
2 

hunt -"e",a$,l 
? zo 
1 

se il carattere cercato non esiste nella stringa, zo=0 
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THE TOOL 

creatst 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 

Note: 


COMPLEMENTI DI BASIC 
Creazione di una stringa 


creatst permette di creare una stringa di caratteri uguali. 

creatst a$. In [,ca$] 

dove 

ca$. stringa di un carattere (opzionale) 
a$ : nome della stringa 

In : lunghezza della stringa che si desidera creare. 

il comando creatst crea una stringa di In caratteri (ca$). In assenza 
chr$ (32). È possibile usare qualunque carattere desiderato. 

creatst a$,80, " " 

si ottiene una stringa di 80 blank 

creatst b$,10,. 

si ottiene una stringa di 10 asterischi 

questa istruzione sostituisce il seguente loop in BASIC: 

for i=l to In 
a$=a$+ca$ 
next i 


CREATST 


di ca$, viene usato 
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CAMPLEMENTI DI BASIC 
Istruzioni di programmazione strutturata 


IF THEN ELSE 


if then else 
Funzione: 

Sintassi: 

Utilizzazione: 

Esempi: 


Note: 


if then else è una versione potenziata dell'equivalente BASIC, che permette una miglior 
programmazione. 

10 if <condizione> then «distruzioni 1> : else «distruzione 2> 
oppure 

10 if <condizioni> then «distruzioni 1> 

20 else -Ostruzioni 2> 

se la condizione è vera, vengono eseguite le istruzioni 1; se è falsa le istruzioni 2. 
Sono possibili fino a 16 if then else nidificati. 

10 if <cl> then <il> 

20 if <c2> then <i2> 

30 if <c3> then <i3> 

40 else <e3> 

50 else <e2> 

60 else <el> 

10 a=2 
20 a=a+l 

30 if a=2 then ? "a=2" : else ? "a=3" 

40 end 

Fate girare questo programma, la prima volta così e la seconda togliendo la riga 20. 

1) il comando if then else può essere usato solo da programma. 

2) sono possibili fino a 16 istruzioni if then else nidificate. Ciò significa che il numero 
degli else deve essere uguale od inferiore al numero degli if then. 
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COMPLEMENTI DI BASIC 
Istruzioni di stampa 


HCOPY 


hcopy 

Funzione: 

Sintassi: 

Utilizzazione: 

Esempio: 

Note: 


hcopy effettua la copia su stampante di tutto ciò che si trova sullo schermo. Se la stam¬ 
pante permette la grafica ad alta risoluzione viene stamapata anche la parte grafico 
presente sullo schermo. 

hcopy senza parametri 

si scrive semplicemente hcopy 

si prende uno degli esempi'precedenti e si aggiunge la linea: 

110 hcopy 

1 ) l'uso di questa funzione arresta il clock interno del COMMODORE 64 durante l'ese¬ 
cuzione. 

2) L'istruzione poke 701,255 permette di ottenere caratteri espansi a doppia larghez¬ 
za sulla stampante 1515. 

L'istruzione poke 701,0 riporta la stampa in modo normale. 

3) L'istruzione poke 702,255 permette di stampare a 9 linee per pollice in modo se¬ 
migrafico. 

L'istruzione poke 702,0 permette infine di stampare a 6 linee per pollice. 
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COMPLEMENTI DI BASIC 


JOY(l) e JOY(2) 


joy(l), joy(2) 

Funzione: joy(l) non è un'istruzione, mo una funzione BASIC nella quale si possono trovare i va¬ 

lori dati dal joystick. 

Sintassi: joy(l) joy(2) senza parametri 

Utilizzazione: questa variabile permette di usare uno o due joystick senza dover effettuare in memoria 
istruzioni di peek, ottenendo quindi una estrema semplicità di programmazione. 

Esempio: inserire il joystick nel relativo connettore (la prima porta a sinistra del COMMODO¬ 

RE 64). 

10 ? joy(l) : goto 10 
run 

10 rem *** disegna sullo schermo ad alta risoluzione *** 

11 graphic : sclear 

12 x=125 : y—199 : ad=128 : plot= x,y,l 
20 cd=joy(l) : ad=cd 

30 if cd=0 then 20 

40 if ad<128 then plot x,y,0 

50 if cd> 128 then cd=cd-128 

60 on cd gosub 110,120,100,140,150,160,100,180,190,200 

70 plot x,y,l : goto 20 

100 return 

110 y—y-f 1 : return 

120 y=y-l : return 

140 x=x—1 : return 

150 x=x—1 : y=y+l : return 

160 x=x—1 : y=y— 1 : return 

180 x=x+l : return 

190 x=x+1 : y=y+l : return 

200 x=x+1 : y=y : return 

Note: 1) con le istruzioni grafiche la funzione joy(l) permette una programmazione vera¬ 

mente piacevole. Vedere il programma dimostrativo CAOl che permette di creare 
con un joystick un diagramma di flusso in modo semiautomatico. 

2) joy(2) corrisponde ad un secondo joystick collegato al secondo connettore presente 
sul COMMODORE 64. La funzione ha lo stesso uso di joy(l). 
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SUPPORTO DOS 


GENERALITÀ 

THE TOOL semplifica la gestione dell'unità a floppy disk con dei semplici e potenti comandi descritti 
nel seguito: 

@ : fornisce il messaggio di errore del floppy disk 

@ $ ; fornisce il catalogo del floppy disk 

© I : inizializza l'unità a floppy disk 

@ V : effettua una raccolta (collect) 

@ N : nome del file, identificazione 

: effettua la formattazione del floppy disk 
© R : nuovo nome di un file=vecchio nome dello stesso file 
: cambia il nome di un file 
@ S : nome del file 

: cancella un file od un programma 
@ C : nuovo nome di un file, vecchio nome dello stesso file 
: effettua una copia del file 

Tutti i comandi descritti debbono essere sempre seguiti dal tasto RETURN. 

Note: per ulteriori dettagli sui comandi descritti e sulla loro sintassi, si rimanda ai manuali 

"Guida per l'utente" del VIC-1540 e del VIC-1541. 
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THE TOOL 


SOMMARIO DELLE ISTRUZIONI 
Parte I 

Generatore di schermo 


APPENDICE A 


Istruzione 

Funzione 

Pagina 

carget a$ [ f l,c] 

- effettua un get intelligente di un carattere predefinito 

3 - 

lé 

clear l,c,lg,ln 

- cancella In caratteri (punto origine: l,c) 

3 - 

5 

clearz n 

- cancella la zona n-esima 

3 - 

15 

decz n,l,c,ln[,ty][,f$] 

- dichiara la zona n-esina 

3 - 

10 

inz n,a$ 

- trasferisce il contenuto della zona n-esina in a$ 

3 - 

13 

out a$,l,c 

- visualizza a$ (punto origine: l,c) 

3 - 

6 

outz n,a$ 

- visualizza a$ nella zona n-esina e controlla a$ 

3 - 

14 

reqz n 

- richiede una risposta nella zona n-esina 

3 - 

12 

rev l,c,lg,ln[,co] 

- inverte il modo video in una porzione dello schermo 

3 - 

7 

sclear 

- cancella tutto lo schermo 

3 - 

20 

screen sc,br[,cr] 

- modifica i colori dello schermo, dei bordi e dei caratteri 

3 - 

21 

scroll l,c,ln,lg,ty 

- effettua lo scroll di una parte dello schermo 

3 - 

8 

sload 8,"nome" 

— carica una pagina dello schermo in memoria 

3 - 

19 

ssave 8,"nome"[,n][,n2 to n3] 

- memorizza su floppy disk una pagina dello schermo 




relativa alle zone definite 

3 - 

18 

tcol ln,l,c 

- traccia una linea verticale lunga In, di origine l,c 

13 - 

4 

♦line ln,l,c 

- traccia una linea orizzontale lunga In, di origine l,c 

13 - 

3 

Variabili riservate 

Significato 



zo 

- codice ASCII per il tasto return in modo request 



ok 

- puntatore di stringa 



Variabili non riservate 

Significato 



a$ 

- stringa 



c 

- numero di colonna (coordinata x) 



ca 

- codice ASCII di un carattere 



co 

- colore (nell'istruzione rev) 



f$ 

- formato di stampa 



1 

- numero di linea (coordinata y) 



ig 

- larghezza o altezza di una finestra (zona) o numero delle righe 



In 

- lunghezza di una finestra o numero delle colonne 



ni ,02,03,0 

- numeri di identificazione delle zone 



ty 

- tipo di formattazione con il comando decz 




- tipo di scroll (u,d,l,r) con il comando scroll 
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SOMMARIO DELLE ISTRUZIONI 
Parte II 


APPENDICE A 

(continua) 


Istruzione 

auto n 

creatst a$,ln[,ca$] 
color [-Jl^/lgJn/CO 
delete 11-12 
display a$,l,c 
draw x,y,ty 
dump 

error 

find <dele><stringa><dele> 

graphic 

hcopy 

hunt [—],ca$ f a$,pn 

if <c> then <i1> : else <i2> 

move x,y 

off 

plot x,y,ty 

point x,y,ty 

renu 11,12,13 
sound al,a2,a3,a4,v 
text 
trace 

Funzioni riservate 

i°yO) 

i°y(2) 

Variabili non riservate 

a$ 

br 

c 

ca 

ca$ 

co 

cr 

<c> 

<dele> 

<il> <i2> 

I 

•g 

In 

11,12,13 

n 

pn 

<stringa> 

se 

ty 

x,y 


Funzione Pagina 

- numera automaticamente le linee di programma 5 - 2 

- crea una stringa di caratteri 6 - 3 

- simile all'istruzione rev, ma in modo Graphic 4-8 

- cancella linee di programma (sintassi simile a list) 5 - 2 

- visualizza su schermo grafico 4 - 6 

- disegna un vettore su schermo grafico 4 - 3 

- fornisce l'elenco di tutte le variabili usate in un program¬ 
ma ed i valori ad esse assegnati 5 - 4 

- localizza un errore in una linea di codice BASIC 5-5 

- effettua la ricerca di caratteri in un programma 5 - 6 

- commuta il computer da modo Text a modo Graphic 4 - 1 

- copia automaticamente lo schermo su stampante 6 - 5 

- effettua la ricerca di un carattere all'interno di una stringa 6 - 2 

- istruzione di programmazione strutturata 6 - 4 

- sposta il cursore in modo grafico senza disegnare 4-2 

- termina il modo di esecuzione passo-passo di un 

programma 5 - 7 

- disegna (o cancella) un punto sullo schermo grafico ad 

alta risoluzione 4 - 4 

- verifica la presenza di un punto sullo schermo grafico 

ad alta risoluzione 4 - 5 

- effettua la rinumerazione delle linee di un programma 5 - 3 

- permette di creare un suono (non ancora implementato) 6 - 6 

- commuta il computer da modo Graphic a modo Text 4 - 7 

- attiva il modo di esecuzione passo-passo di un programma 5 - 7 


Contenuto 

- valore dato dal joystick 1 

- valore dato dal joystick 2 

Significato 

- una qualunque stringa di caratteri 

- colore del bordo 

- punto origine (numero di colonna) 

- valore ASCII 

- carattere da ricercare 

- colore opzionale 

- colore del carattere 

- condizione (es: A=B) 

- delimitatore (qualunque carattere tranne ") 

- istruzioni 

- punto origine (numero di riga) 

- altezza (numero di righe) 

- lunghezza (numero di,colonne) 

- numeri di linea di un programma 

- incremento per la memorizzazione automatica 

- puntatore di posizione per la ricerca di un carattere in 
una stringa 

- caratteri da ricercare in un programma 

- colore dello schermo 

- variabile numerica (1 disegna - 2 cancella) 

- coordinate di un punto dello schermo 
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MESSAGGI DI ERRORE 
generati da THE TOOL 


APPENDICE B 


Messaggio Spiegazione 

BAD FORMAT durante l'esecuzione di un comando decz di tipo p, il formato definito non corrisponde 
a quello della variabile - problemi di lunghezza (vedi pag. 3 - 10) 

NO COLOR manca il parametro del colore oppure il parametro fornito non è permesso 
(vedi pag. 3-21) 

NO ZONE un'istruzione tipo-z è stata lanciata in una zona non dichiarata (vedi da pag. 3 - 9 o 3 -15) 

OUT OF PAGE le coordinate del punto di origine, oppure il valore dell'altezza forniti in un'istruzione 
del generatore di schermo sono valori errati. 








































